home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / psion / s3host10.lha / s3host.doc < prev    next >
Text File  |  1994-03-02  |  7KB  |  211 lines
  1.  
  2.  
  3. S3Host
  4. ******
  5.  
  6.    This document describes the use of the S3Host program, a utility
  7. to simplify file transfers between Amiga and Psion S3 and S3a
  8. palmtop computers.
  9.  
  10.        S3Host is (C) 1994 Oliver Wagner, All Rights Reserved.
  11.  
  12. What is S3Host?
  13. ***************
  14.  
  15.        S3Host is a utility which simplifies file transfers between
  16. Amiga and Psion S3/S3a palmtop computers. It features:
  17.  
  18. Y-Modem-G
  19.      S3Host utilizies the Y-Modem-G protocol to minimize overhead and
  20.      allow for batch transfers.  Y-Modem-G is comparable to Z-Modem,
  21.      but is more efficient on reliable links.
  22.  
  23.      Also, a Y-Modem-G driver is built into the S3's ROM, so you don't
  24.      need any special software (and memory) on the S3 side.
  25.  
  26. Automatic Send/Receive handling
  27.      You don't need to worry about sending files - just drop them into
  28.      the Send Listview.  S3Host automatically detects when the S3
  29.      terminal enters receive mode and starts sending files.
  30.  
  31.      Also, S3Host detects incoming files and starts receiving them into
  32.      the predefined destination directory without any user interaction.
  33.  
  34. ARexx
  35.      S3Host's ARexx port allows to write scripts for regularly done
  36.      file transfers, for example to back up your database.
  37.  
  38. Requirements
  39. ************
  40.  
  41. 1. Amiga OS 2.04 or better
  42.      S3Host has been tested on OS 2.04, OS 3.0 and OS 3.1 machines. You
  43.      should always use the latest version of AmigaOS to improve your
  44.      general system performance.
  45.  
  46. 2. MUI 2.0 or better
  47.      S3Host is a MUI application.  MUI, the Magic User Interface, is
  48.      (C) 1993 Stefan Stuntz.
  49.  
  50.      MUI isn't included in the S3Host distribution archive, but can be
  51.      found on various FD disks, BBS's and FTP sites.  If you don't know
  52.      MUI, you should take a look at it, it is well worth the effort.
  53.  
  54.      Remember:  MUI is Shareware.  You should register if you use MUI
  55.      applications on a regular basis.
  56.  
  57. 3. Psion S3 or S3a palmtop computers
  58.      It might work with HCs or MCs as well ;-)
  59.  
  60. 4. 3-Link RS232 cable
  61.      The PC version of the 3-Link cable is required, the Mac version
  62.      won't properly connect to the Amiga.
  63.  
  64. 5. Knowledge of the S3/S3a Comms Application
  65.      If you're a S3 owner, you need to install the Comms application
  66.      which is built into the 3-Link cable.  The S3a has a special
  67.      version of Comms build into it's ROM.
  68.  
  69.      You should carefully read the 3-Link manual to learn how to use the
  70.      Comms application. Knowledge of it's scripting language may help
  71.      you as well, but isn't required for normal operation.
  72.  
  73. Copyright
  74. *********
  75.  
  76.        S3Host is Freeware and may be distributed in any form, as long
  77. as the code and this manual are unchanged and both are included in the
  78. distribution.
  79.  
  80.    If you like it so much that you want to spend money for it, don't
  81. send it to me, but instead consider registering MUI, if you don't
  82. already did so.
  83.  
  84.    If you have questions, suggestions or bug-reports, send them to
  85. o.wagner@aworld.aworld.de.  Public discussion of Psion related
  86. stuff can be done in the newsgroup comp.sys.psion, or
  87. comp.sys.amiga.applications for Amiga/Psion related discussions.
  88.  
  89. Installing S3Host
  90. *****************
  91.  
  92.    The provided Installer script Install_S3Host will copy S3Host
  93. and it's online documentation onto your harddisk.
  94.  
  95.    You must install MUI on your system before you can use S3Host.
  96.  
  97. Using S3Host
  98. ************
  99.  
  100.    Using S3Host is quite simple.
  101.  
  102.   1. Configure the serial settings. Remember that 19200 bps is only
  103.      supported on the S3a, not the S3.
  104.  
  105.   2. Start the terminal application on your S3 or S3a.  Be sure to set
  106.      it to the same serial settings as S3Host.  Select Y-Modem-G as
  107.      the file transfer protocol.
  108.  
  109.   3. Set S3Host to Online.
  110.  
  111.   4. Send files from the Amiga to the S3 by adding them to the send
  112.      listview, or simply drop icons into the listview.  Start the
  113.      transfer by selecting Receive on the S3/S3a.
  114.  
  115.   5. Receive files from the S3 by first selecting the files with the S3
  116.      terminal and then start the transfer by clicking on the
  117.      Receive gadget.  The Received Files listview will show up
  118.      with all files received.
  119.  
  120.  
  121.    You may abort the transfer at any time by setting S3Host to
  122. Offline.
  123.  
  124. ARexx
  125. *****
  126.  
  127.    S3Host features a ARexx port named "S3Host".  Some of the commands
  128. take arguments, which are indicated as standard shell templates.
  129.  
  130. Quit
  131.          Quit causes S3Host to terminate. This is a builtin MUI
  132.      command.
  133.  
  134. Hide
  135.          Hide causes S3Host to iconify. This is a builtin MUI
  136.      command.
  137.  
  138. Show
  139.          Show causes S3Host to deiconify. This is a builtin MUI
  140.      command.
  141.  
  142. Help File/A
  143.      Writes a list of all ARexx commands support by S3Host to the file
  144.      named File.  This is a builtin MUI command.
  145.  
  146. Receive
  147.          Receive forces S3Host to send a Receiver Ready character
  148.      ('G') to the S3/S3a. If Comms is about to send files, this will
  149.      start the transfer.
  150.  
  151. Send Files/M/A
  152.      Puts the indicated files on the send list.  Sending will be
  153.      started if the remote machine (i.e.  the S3/S3a) signals Receiver
  154.      Ready.
  155.  
  156.      This command returns "0" if everything went ok, or "5" if one or
  157.      more files don't exist.
  158.  
  159. Online
  160.      Forces S3Host to go online.
  161.  
  162. Offline
  163.      Forces S3Host to go offline. Any pending transfers will be
  164.      aborted, and the serial driver is released.
  165.  
  166. IsOnline
  167.      Checks whether S3Host is currently online.  Returns "0" for
  168.      offline and "1" for online.
  169.  
  170. Acknowledgments
  171. ***************
  172.  
  173.    Acknowledgments must go to the following people:
  174.  
  175. Stefan Stuntz
  176.      for providing AmigaOS with the most sophisticated object oriented
  177.      User Interface of all current computer platforms:  MUI.  Without
  178.      the existance of MUI, S3Host wouldn't have been written.
  179.  
  180. Sandro Paolini, Holger Lubitz
  181.      for beta-testing.
  182.  
  183. Matthias H÷lscher of Psion GmbH, Germany
  184.      for providing helpful development support.
  185.  
  186. Reinhard Spisser and Sebastiano Vigna
  187.      for creating MakeInfo for AmigaOS
  188.  
  189. Psion UK. Ltd.
  190.      for creating the first really usable palmtop computer ever:  The
  191.      Series 3.  Too bad that they still don't support AmigaOS, because
  192.      the S3 and the Amiga are a great team for all your computing needs
  193.      ;-)
  194.  
  195. SAS Inc.
  196.      for providing and maintaining the great SAS/C development package.
  197.  
  198. Index
  199. *****
  200.  
  201.  
  202.  
  203.  Acknowledgments                        Acknowledgments
  204.  ARexx                                  ARexx
  205.  Copyright                              Copyright
  206.  Installing S3Host                      Installing S3Host
  207.  Requirements                           Requirements
  208.  Using S3Host                           Using S3Host
  209.  What is S3Host?                        What is S3Host?
  210.  
  211.